home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / ip / ka9q / xobbs.arc / read_me < prev    next >
Text File  |  1989-05-03  |  4KB  |  83 lines
  1. Some very criptic notes on the XOBBS.
  2.  
  3. The bbs code runs only on SysV at the moment. BSD usage will require
  4. coercing the SysV IPC Message Queue stuff into Unix Domain Sockets.
  5. This is left as an exercise to the reader.
  6.  
  7. The Module "ax_mbx.c" and its companion header "ax_mbx.h" are
  8. replacements for the W9NK mailbox.
  9.  
  10. The 'dif' files are changes to 'net' itself, in particular , the
  11. .33a(w9nk, kd8wk) version, but should be usable with any version
  12. that supports the W9NK mailbox.
  13.  
  14. Now, the AH-HEM  ssid question. I prefer to use a second SSID
  15. for the bbs so that a carriage return is not necessary to start
  16. the bbs. This is the scheme I am using and have had no problems
  17. concerning the operation of the TCP and net/rom sessions.
  18. The choice is yours. I have included a definition SID2 in the
  19. code. If you define this in the makefile, you get two ssids,
  20. which are named by the entries 'ax25 mycall W3XXX' and 
  21. 'ax25 bbscall W3XXX-1' for example, in the startup.net file.
  22. Four source files in 'net' have been '#ifdef'd' so that the
  23. proper things happen. If you choose not to use the second
  24. SSID, then your users will have to send a CR to start the
  25. bbs.  Incidentally, using the two SSIDs allows ax25 connections
  26. to your 'mycall' ID to spawn incoming ax25 terminal sessions.
  27. This is probably a plus, as you can still have your non-bbs
  28. buddies open terminal sessions to you while the bbs is running
  29. on the other SSID.
  30.  
  31. I have been beating upon the functional aspects of the code and
  32. may have neglected some of the startup niceties. If things don't
  33. fire up, you may need to create null files for xouser or  bbsmotd
  34. or any other file for which the bbs will look upon its creation.
  35. Check "config.xo" to see how things should be layed out.
  36.  
  37. Basically, there are 4 message queues created in the system
  38. by net for use by the mailbox; Send, Receive, Control Send and
  39. Control Receive. Control recieve is currently not used. These
  40. are reported by descriptor number upon startup of net. The PID of
  41. each mailbox  spawned is saved in the mailbox session structure
  42. and used as the "message type" for the message queues to steer
  43. the message to the desired bbs. For those unfamiliar with
  44. message queues on SysV, each message has a "message type"
  45. , which is a  long integer, attached. It is possible to selectively
  46. receive from a que by specifying the messafe type, thus allowing
  47. each bbs to block on the queue until input for it arrives. Likewise,
  48. NET looks for a message on the send queue that has the message type
  49. that corresponds numerically to the PID of the bbs as it climbs
  50. though the session list. If such a message arrives, NET transmits
  51. it over the ax25 link specified in that mailbox session structure.
  52. On recieve, NET checks each receive upcall's axp against all the
  53. axp's saved in the mailbox session structures and , when a match
  54. is found, sends that data "down  the pipe" to the bbs by attaching
  55. the bbs's PID as a message type to a message on the receive queue.
  56. If the bbs wishes to be killed, it sends a kill request up the
  57. message que to the NET  process, which is non-selectively receiving
  58. on the Control Send queue. NET ascertains the PID of the bbs requesting
  59. to be killed and does a kill -9 on that PID. The only other use
  60. of the Control Send queue is when the forwarding bbs wishes to
  61. inform net that either it is finished forwarding to a particular
  62. mailbox and wishes to go to the next connection, or it has failed
  63. and wishes to go the next mailbox in the forwarding file.
  64.  
  65.  
  66. Multi-bbs access to the mail files is accomplished by a daemon
  67. process call "maildaemon.c". This process is started up as
  68. a background task in the mailbox home directory.
  69.  
  70. You will need to create the subdirectories "fwding", "mail" and
  71. "temp" in the bbs home directory. You will probably need to create
  72. a null "highnum" file and perhaps a null "xouserfile".
  73. Look at "config.xo".
  74.  
  75. "trigger.c" spawns the forwarder.
  76.  
  77. Local invocation of the mailbox (from the shell prompt) is
  78. "xobbs call".
  79.  
  80. -Jim    (pitt!w2xo!durham)
  81.  
  82.  
  83.